JS API 的加载

您所在的位置：网站首页 › 阿里LinkWAN SDK › JS API 的加载

JS API 的加载

2023-03-30 15:42| 来源: 网络整理| 查看: 265

JS API 2.0 版本提供了两种方案引入地图 JS API：

1. 使用官网提供的JS API Loader进行加载；

2. 以常规 JavaScript 脚本的方式加载；

注意

为避免地图数据协议和前端资源不匹配导致页面运行报错，只允许在线加载 JS API，禁止进行本地转存、与其它代码混合打包等用法。

准备成为开发者并创建 key

为了正常调用 API ，请先注册成为高德开放平台开发者，并申请 web 平台（JS API）的 key 和安全密钥，点击具体操作。

使用 JS API Loader (推荐)

JS API Loader是我们提供的 API 加载器，可帮助开发者快速定位、有效避免加载引用地图 JS API 各种错误用法，具有以下特性：

支持以普通 JS 和 npm包两种方式使用；有效避免错误异步加载导致的 JS API 资源加载不完整问题；对于加载混用多个版本 JS API 的错误用法给予报错处理；对于不合法加载引用 JS API 给予报错处理；支持指定 JS API 版本；支持插件加载；允许多次执行加载操作，网络资源不会重复请求，便于大型工程模块管理；支持IE9以上的浏览器，不支持IE8以下按普通 JS 方式使用 Loader

使用Loader

注意

您在2021年12月02日以后申请的 key 需要配合您的安全密钥一起使用。

使用：

JS API示例

AMapUI示例

Loca示例

按 NPM 方式使用 Loader

安装：

npm i @amap/amap-jsapi-loader --save注意

您在2021年12月02日以后申请的 key 需要配合您的安全密钥一起使用。

按 NPM 方式使用 Loader 设置 key 和安全密钥：

使用：

import AMapLoader from '@amap/amap-jsapi-loader'; window._AMapSecurityConfig = { securityJsCode:'「您申请的安全密钥」', } AMapLoader.load({ "key": "", // 申请好的Web端开发者Key，首次调用 load 时必填 "version": "2.0", // 指定要加载的 JS API 的版本，缺省时默认为 1.4.15 "plugins": [], // 需要使用的的插件列表，如比例尺'AMap.Scale'等 }).then((AMap)=>{ map = new AMap.Map('container'); }).catch(e => { console.log(e); })

JS API示例

AMapUI示例

Loca示例

直接加载 JS API 脚本JS API 脚本同步加载注意

您在2021年12月02日以后申请的 key 需要配合您的安全密钥一起使用。

使用：

window._AMapSecurityConfig = { securityJsCode:'「您申请的安全密钥」', } // 地图初始化应该在地图容器div已经添加到DOM树之后 var map = new AMap.Map('container', { zoom:12 }) JS API 脚本异步加载特别注意

异步加载指的是通过appendChild将 JS API 的script标签添加到页面中，或者给script标签添加了async属性的使用方式。这种使用场景下，JS API不会阻塞页面其他内容的执行和解析，但是 JS API 的脚本解析将有可能发生其他脚本资源执行之后，因为需要特别处理，以保证在AMap对象完整生成之后再调用 JSAPI 的相关接口，否则有可能报错。

使用：

注意

异步回调函数的声明应该在 JS API 引入之前

//设置您的安全密钥 window._AMapSecurityConfig = { securityJsCode:'「您申请的安全密钥」', } // 声明异步加载回调函数 window.onLoad = function(){ var map = new AMap.Map('container'); } var url = 'https://webapi.amap.com/maps?v=2.0&key=您申请的key值&callback=onLoad'; var jsapi = document.createElement('script'); jsapi.charset = 'utf-8'; jsapi.src = url; document.head.appendChild(jsapi);

async

// 声明异步加载回调函数 //设置您的安全密钥 window._AMapSecurityConfig = { securityJsCode:'「您申请的安全密钥」', } window.onLoad = function(){ var map = new AMap.Map('container'); }

【本文地址】

JS API 的加载

JS API 的加载

今日新闻

推荐新闻